home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / gfx / show / tapdl13.lha / tapdl.man < prev    next >
Text File  |  1994-12-05  |  5KB  |  161 lines
  1.  
  2.  
  3.  
  4.     TAPDL 1.3                                                 05.12.94
  5.  
  6.  
  7.  
  8.     ABOUT
  9.  
  10.     This is a DL animation player for 020+/KS2 machines. It should be
  11.     able to play version 1, 2 and 3 files, and will automatically
  12.     unpack files that have been compressed with XPK.
  13.  
  14.     DL files are a kind of animation found on PCs. The animations are
  15.     320x200 or smaller, in 256 colors. The colors are 18 bits each, 6
  16.     per gun. On a machine without AGA, the GRAY option should be used.
  17.  
  18.     Version 3 DLs are reputed to support sound and password features
  19.     which TAPDL does not. I have not seen a DL file that uses these
  20.     features.
  21.  
  22.     TAPDL can be made resident for command line users. To extract it
  23.     from the archive with the "pure" bit set, use LHA's "-a" switch,
  24.     or you can type "protect tapdI p add" in a CLI.
  25.  
  26.     TAPDL is Copyright © 1994 by John Bickers.
  27.  
  28.  
  29.     REQUIREMENTS
  30.  
  31.     TAPDL will work best on an AGA/020+/KS3 machine, but as a minimum
  32.     it requires an 020+/KS2 machine and the ReqTools and XPK
  33.     libraries. These libraries can be found on the Aminet sites in
  34.     util/libs and util/arc respectively.
  35.  
  36.  
  37.     PARAMETERS
  38.  
  39.     The command template is:
  40.  
  41.     FILES/M,DELAY/K/N,FONT/K,GRAY/S,TIME/S
  42.  
  43.     The FILES option is one or more names of DLs that you want to
  44.     play. If you leave this blank, then a file requester will appear.
  45.  
  46.     The DELAY option is a number, in 100ths of a second, for how long
  47.     TAPDL should delay between frames. The default value is 15.
  48.  
  49.     The FONT option is a font name, including the ".font" extension,
  50.     to use for the TAPDL screen. An 8-point non-proportional version
  51.     of the font will be requested. The default is dlview3.font.
  52.  
  53.     The GRAY option makes TAPDL convert the animation to grayscale
  54.     before playing it. This option is should be used on machines that
  55.     do not have AGA.
  56.  
  57.  
  58.     KEYBOARD CONTROL
  59.  
  60.     When an animation is being played, the following keys control the
  61.     playback. They are similar to the controls allowed by SPARTA Inc's
  62.     ShowANIM.
  63.  
  64.     F1,...,F10  Set different speeds. F1 is the fastest.
  65.  
  66.     Down        Pause the animation.
  67.  
  68.     Right       Forward one frame.
  69.  
  70.     Up          Resume the animation.
  71.  
  72.  
  73.     CREDITS
  74.  
  75.     TAPDL is written by John Bickers using SAS C 6.51.
  76.  
  77.     Thanks to Christian Geisert for a variety of sample files, bug
  78.     reports, and valuable suggestions. Thanks also to Andy Philpotts
  79.     for supplying me with my first version 3 DL file. And thanks to
  80.     Keith Stewart for testing TAPDL on a non-AGA machine.
  81.  
  82.     The DL file format and PC programs were created by Davide Tome'
  83.     and Luca De Gregorio. The format of a DL file was obtained by
  84.     looking at sample files, and running Davide and Luca's DL-VIEW.EXE
  85.     under Microsoft's CodeView debugger. The "dlview3" font included
  86.     with TAPDL is copied from their PC program. The 16-point font is
  87.     an exact copy, while the 8-point font is a clone. Both were made
  88.     with Adam Costello's BMFC.
  89.  
  90.     The chunky-to-planar routine used is the c2p_020 routine from the
  91.     net, written by James McCoull, Peter McGavin et al.
  92.  
  93.     ReqTools is Copyright (c) Nico François.
  94.  
  95.     The xpkmaster.library and sublibraries are the work of U. Dominik
  96.     Mueller and colleagues.
  97.  
  98.  
  99.     DISTRIBUTION
  100.  
  101.     TAPDL is Copyright © 1994 by John Bickers.
  102.  
  103.     Distribution is via normal channels. That is, distribute it for
  104.     free or for Fred Fish like costs, but not more. And remember to
  105.     include the documentation.
  106.  
  107.     If you want to contribute something to the cause of PC animation
  108.     playback, you might want to consider sending me a CD of anims, or
  109.     a movie CD.
  110.  
  111.     If you're putting together a CD of animations and you want to put
  112.     TAPDL onto it, by all means do so. Send me a copy of the CD in
  113.     lieu of any fee. Contact me at the address below if you want any
  114.     customisation of the program done.
  115.  
  116.  
  117.     CONTACT INFO
  118.  
  119.     I can be reached at:
  120.  
  121.         John Bickers
  122.         214 Rata St
  123.         Naenae
  124.         New Zealand
  125.  
  126.     Or: jbickers@templar.actrix.gen.nz
  127.  
  128.     Or: +64 4 567 7334 (home) +64 4 474 6625 (work)
  129.  
  130.  
  131.     DISCLAIMER
  132.  
  133.     It works on my machine.
  134.  
  135.  
  136.     HISTORY
  137.  
  138.     94.07.12    Created 1.0.
  139.     94.07.21    1.1.
  140.                 Handles multiple filenames on the command line.
  141.                 Handles multiselect in file requester.
  142.                 Sets wait pointer while doing chunky -> planar stuff.
  143.                 Title/Author screen falls back to topaz.font.
  144.     94.07.25    Fixed bug where 80x50 anims left title displayed.
  145.     94.08.22    1.2.
  146.                 Resets screen color before opening file requester.
  147.                 Added GRAY option, so it doesn't strictly require AGA.
  148.     94.09.12    Sets wait pointer while loading file (XpkUnpack()).
  149.                 Uses header seq. length to avoid trailing junk bytes.
  150.     94.11.16    Added support for type 3 DLs using MOUTH.DL.
  151.                 Finally fixed screen font bug, I think.
  152.     94.11.18    Removed GRAY option, too much hassle for my c2p code.
  153.     94.11.19    Fixed bug where CLI arguments weren't being freed.
  154.                 Added FONT option.
  155.                 Changed default font from DarkParticle to dlview3.
  156.     94.11.21    1.3
  157.                 Improved tapc2p a little.
  158.     94.11.28    Now uses c2p_020 instead, smooth for worst-case.
  159.     94.12.05    Custom double-buffering, so KS3 no longer required.
  160.                 Restored GRAY option, so AGA no longer required.
  161.